Skip to main content

Error Handling


Keepz API errors follow a standardized format. Each error is returned with an HTTP status code (in the response header) and a JSON body:

{
"message": "Client not found for given id.",
"statusCode": 5003
}

Fields:

ParameterTypeDescription
messagestringHuman-readable error description.
statusCodenumberUnique error code assigned by Keepz.
Status codeMessage
5003Client not found for given id.
5006Failed to update CREDO distributor transaction status, transaction not found!
5013Invalid grant type!
5015Client balance not found with given client id.
5017Transaction with such unique ID already exists!
5021Incorrect credentials.
5023Invalid IBAN.
5033Distribution strategy not found for given type.
5038Couldn't make transaction. Insufficient balance amount.
5039Not valid method argument.
5040Unhandled general exception.
5041Receiver user not found with given receiverId and receiverType.
5042Method argument type mismatch.
5043Http message not readable.
5045Amount below minimum transaction amount.
5046Amount above maximum transaction amount.
5047Permission not found for debtor params.
5048Permission not found for integrator custom distribution iban.
5050Currency not allowed!
5051Currency config not found for given client.